home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / lasso13.zip / LASSO!.DOC < prev    next >
Text File  |  1992-12-08  |  13KB  |  335 lines
  1.  
  2.  
  3.                        ============================
  4.                                   Lasso!
  5.                        ============================
  6.                            (c)1992 T&J Software
  7.  
  8.         One of the T&J Software Collection of multi-BBS door programs.
  9.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  10.              UltraBBS, Telegard, TriBBS, Remote Access, WWIV, and
  11.                                 Digiboard
  12.  
  13.                        VERSION 1.30     12/01/92
  14.  
  15.                                    By
  16.  
  17.                             Tom & Jane Wildoner
  18.                              397 West Broadway
  19.                               Jim Thorpe, PA
  20.                                   18229
  21.                             VOICE (717)325-9480
  22.                    *between 5:30 & 10:00 p.m. Eastern Time
  23.  
  24.                                   From
  25.  
  26.                                The T&J BBS
  27.                               (717)325-9481
  28.                         1200/2400/9600/19200/38400
  29.                                24 Hours/Day
  30.  
  31. LATEST VERSION:
  32. ===============
  33.  
  34. Please call the T&J BBS for the latest version of this program.
  35.  
  36. LEGALITIES:
  37. ===========
  38.  
  39. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  40. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  41. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  42. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  43. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  44. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  45.  
  46. DISTRIBUTION:
  47. =============
  48.  
  49. You may make this file available for downloading from your BBS or you may
  50. upload it to any BBS of your choice, provided that you do not make any
  51. changes to the contents of the archive (ZIP file). The archive and its
  52. individual contents may not be used by any service that charges any money
  53. whatsoever, without the written permission of the author.
  54.  
  55. PROGRAM DESCRIPTION:
  56. ====================
  57.  
  58. Lasso! is a "take off" of the popular hangman game. The door comes with
  59. OVER 27,000 words in its word listing (your users should not get bored very
  60. easily with this one)!
  61.  
  62. The registered version allows you to set the number of words per play a
  63. user may guess at, and will also allow you to set the number of times a
  64. person may play per day.
  65.  
  66. Lasso! will keep track of how many times the door was opened, how many
  67. "hangin's" there were, and the date of the last entry.
  68.  
  69. NOTE:
  70. =====
  71.  
  72. The LASSO!.KEY file that is distributed with this door does NOT expire!
  73. This is simply here so the door has a KEY to read. When you register,
  74. you will receive a new LASSO!.KEY file.
  75.  
  76. The user is limited to ONE play per day and only THREE words per play
  77. until registered.
  78.  
  79. FEATURES:
  80. =========
  81.            --- Desqview Aware.
  82.            --- COM1-4 support and non-standard IRQ's.
  83.            --- Colorful ANSI screens.
  84.            --- Chat function.
  85.            --- NO BRUN module needed for play.
  86.            --- BETA tested on five different boards.
  87.            --- Will return to BBS on dropped carrier.
  88.            --- Will TIMEOUT a player after 5 minutes of no activity.
  89.            --- Use of HOT KEYS while in the door.
  90.            --- Handy statistics presented to user on door usage.
  91.            --- Support BBS available.
  92.            --- Easily RESET the entire program.
  93.            --- Over 27,000 words in it's dictionary!
  94.            --- ANSI/ASCII Bulletin Creation!
  95.            --- Fossil driver support
  96.  
  97. INSTALLATION:
  98. =============
  99.  
  100. Lasso can be easily configured by running LASSO! with the command line
  101. UTILITY.
  102.  
  103. Example:  LASSO! UTILITY
  104.  
  105.  
  106. CONFIGURATION:
  107. =============
  108.  
  109. Example configuration file for PCBOARD.SYS
  110. ------------------------------------------
  111.  
  112. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  113. T&J Software        <=-  (Change this to your BBS name)
  114. Tom                 <=-  (The Sysop's first name)
  115. Wildoner            <=-  (The Sysop's last name)
  116.  
  117. Example configuration file for USERS.SYS
  118. ----------------------------------------
  119.  
  120. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  121. T&J Software        <=-  (Change this to your BBS name)
  122. Tom                 <=-  (The Sysop's first name)
  123. Wildoner            <=-  (The Sysop's last name)
  124.  
  125. Example configuration file for DOOR.SYS
  126. ---------------------------------------
  127.  
  128. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  129. T&J Software        <=-  (Change this to your BBS name)
  130. Tom                 <=-  (The Sysop's first name)
  131. Wildoner            <=-  (The Sysop's last name)
  132.  
  133. Example configuration file for USERINFO.DAT
  134. -------------------------------------------
  135.  
  136. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  137. T&J Software        <=-  (Change this to your BBS name)
  138. Tom                 <=-  (The Sysop's first name)
  139. Wildoner            <=-  (The Sysop's last name)
  140. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  141.  
  142. Example configuration file for CALLINFO.BBS
  143. -------------------------------------------
  144.  
  145. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  146. T&J Software        <=-  (Change this to your BBS name)
  147. Tom                 <=-  (The Sysop's first name)
  148. Wildoner            <=-  (The Sysop's last name)
  149.  
  150. Example configuration file for DORINFOx.DEF
  151. -------------------------------------------
  152.  
  153. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  154.                           where 'x' is the BBS Node number.
  155. T&J Software        <=-  (Change this to your BBS name)
  156. Tom                 <=-  (The Sysop's first name)
  157. Wildoner            <=-  (The Sysop's last name)
  158.  
  159. Example configuration file for SFDOORS.DAT
  160. ------------------------------------------
  161.  
  162. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  163. T&J Software        <=-  (Change this to your BBS name)
  164. Tom                 <=-  (The Sysop's first name)
  165. Wildoner            <=-  (The Sysop's last name)
  166.  
  167. Example configuration file for CHAIN.TXT
  168. ----------------------------------------
  169.  
  170. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  171. T&J Software        <=-  (Change this to your BBS name)
  172. Tom                 <=-  (The Sysop's first name)
  173. Wildoner            <=-  (The Sysop's last name)
  174.  
  175. Example configuration file for GTUSER.BBS
  176. -----------------------------------------
  177.  
  178. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  179. T&J Software        <=-  (Change this to your BBS name)
  180. Tom                 <=-  (The Sysop's first name)
  181. Wildoner            <=-  (The Sysop's last name)
  182. 1                   <=-  (COM port number - defaults to 1)
  183. 1                   <=-  (Node number - defaults to 1)
  184.  
  185. Example Batch File
  186. ==================
  187.  
  188. A sample batch file is included and is similer to the following:
  189.    ECHO OFF
  190.    CD\DOORS\LEMON           <=- Switch to the door's Directory.
  191.    LASSO! LASSO!.CFG        <=- Execute the door program and pass the
  192.                                 configuration filename to the program.
  193.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  194.    BOARD                    <=- Restart BBS.
  195.  
  196. This Door is multi-node  compatible so you may run more than 1 node from
  197. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  198. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  199. variables, (q.v.)
  200.  
  201. Environment Variables
  202. =====================
  203.  
  204. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  205. variables. Non-PCBoard systems may also use these variables by including
  206. the following in either your BBS batch or AUTOEXEC.BAT
  207.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  208.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  209. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  210. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  211. .CFG file for multi-node operation!
  212.  
  213. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  214. command line.  For example:
  215.  
  216.      LASSO! LASSO!.CFG /5
  217. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  218.      LASSO! LASSO!.CFG /%IRQ%
  219.  
  220. This tells the program to use IRQ 5 instead of the standard IRQ.
  221.  
  222.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  223.  systems. Seems Novell also uses the / character so something went screwy
  224.  somewhere. So I added the * (asterisk) which may be used instead of the /
  225.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  226.  and are interchangeable.
  227.  
  228. When specifying the location of the system file on line 1 of the doors .CFG
  229. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  230. and %wcnodeid%. Some examples:
  231.  PCBoard: 
  232.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  233.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  234.  
  235.  Wildcat!:
  236.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  237.  
  238. Non-PCBoard systems may use the PCB environment variables by setting them
  239. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  240.  SET PCBDRIVE=C:
  241.  SET PCBDIR=\BBSDIR
  242.  SET PCBNODE=1
  243.  
  244. Fossil Driver Support
  245. ---------------------
  246. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  247. Fossil driver instead of the standard COM ports, just put /FD on the command
  248. line when running the door. For example:
  249.      MYDOOR MYDOOR.CFG /FD
  250. indicates that a Fossil driver is present and should be used. If no Fossil
  251. driver is detected, DoorFrame will print a message to that effect and exit
  252. the door gracefully.
  253.  
  254.  
  255. Sysop Keys
  256. ==========
  257.  
  258. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  259.          written to DOOR.SYS and USERS.SYS
  260. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  261.          and/or written to DOOR.SYS and USERS.SYS
  262. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  263. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  264.          and/or written to DOOR.SYS and USERS.SYS
  265. F8    -  Returns the caller involuntarily to the BBS.
  266. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  267.          and/or written to DOOR.SYS and USERS.SYS
  268. F10   -  Activates SysOp CHAT mode within the DOOR.
  269. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  270. UP    -  Give the caller extra time while in the DOOR.  
  271. DN    -  Subtract time from the caller while in the DOOR. 
  272. HOME  -  HELP key for Status Line options.
  273. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  274. ALT-X -  PCBoard will exit after current caller logs off. Value is
  275.          passed to PCBoard. Not available on non-PCBoard systems.
  276.  
  277.  
  278. Your SYSOP.CFG file should contain ALL the items listed below. You can use
  279. your text editor to edit the provided file.
  280.  
  281. c:\wc30\bull\bull1.scr
  282. c:\wc30\bull\bull1.bbs
  283. 25
  284. 2
  285.  
  286. LINE   1: PATH to your color bulletin.
  287. LINE   2: PATH to your ASCII bulletin.
  288. LINE   3: Number of words per play.
  289. LINE   4: Number of plays per day.
  290.  
  291. The file MUST have all 4 lines!
  292.  
  293. Local Play:
  294. ==========
  295.  
  296. Just run Lasso! with the command line LOCAL.
  297.  
  298. Example:  LASSO! LOCAL
  299.  
  300. MAINTENANCE!:
  301. ============
  302.  
  303. Daily maintenance is taken care of by the door. The door resets with
  304. the first player of the new month!
  305.  
  306. FUTURE VERSIONS:
  307. ================
  308.  
  309. 1.] Allow users to input their own words into the dictionary.
  310.  
  311. Let me know what you would like to see added!
  312.  
  313. VERSION HISTORY:
  314. ===============
  315.  
  316. Version 1.00 ......... First release. 05/11/92
  317. Version 1.10 ......... Updated to newest routines and fixed small glitch
  318.                        that sometimes showed up after larger words were
  319.                        picked. 05-15-92
  320. Version 1.20 ......... Upgraded with newest door routines. 05-24-92
  321. Version 1.30 ......... Upgraded with the newest routines, supports fossil
  322.                        drivers. Now supports the short form of DOOR.SYS.
  323.                        Added the UTILITY command line which really makes
  324.                        things easier when configuring the door. Also,
  325.                        added over 19,000 new words! 12-01-1992
  326.  
  327. REGISTERING:
  328. ============
  329.  
  330. That's all there is to it! If you have any problems or questions
  331. please feel free to call the T&J BBS at (717)325-9481 and join the
  332. T&J Software Conference.
  333.  
  334. See the enclosed registration form for ordering!  (REGISTER.TXT)
  335.